home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / program / qlib205.zip / QLIB.ZIP / TXT / WIN95.TXT < prev   
Text File  |  1997-03-16  |  4KB  |  88 lines
  1. Win95 Functions
  2. ---------------
  3.  
  4. Notes:
  5.   It is not neccessary to check for Win95 before calling any of these
  6.     funcs.  They will all just fail if not under Win95.
  7.   The names displayed on the Win95 toolbar is as follows:
  8.     VM_name - prog_name
  9.   See test\win95.c for a good example.
  10. -----------------------------------------------------------------------------
  11. Function: win95_title_set(char * str1)
  12. Expects: str1 = new program name
  13. Outputs: 0 = successful
  14.          -1 = unsuccessful
  15. Notes:
  16.   This sets the program name of the current running program that is
  17.     displayed on the toolbar of Win95.
  18.   Max length is 79 chars plus the NULL.
  19. -----------------------------------------------------------------------------
  20. Function: win95_vmtitle_set(char * str1)
  21. Expects: str1 = new VM name
  22. Outputs: 0 = successful
  23.          -1 = unsuccessful
  24. Notes:
  25.   This sets the VM name of the current running program that is
  26.     displayed on the toolbar of Win95.
  27.   This MUST be restored before terminating.  See win95_vmtitle_get().
  28.   Max length is 79 chars plus the NULL.
  29. -----------------------------------------------------------------------------
  30. Function: win95_title_get(char * str1,dword strsiz)
  31. Expects: str1 = buffer for current program name
  32.          strsiz = size of your string
  33. Outputs: 0 = successful
  34.          -1 = unsuccessful
  35. Notes:
  36.   This gets the program name of the current running program that is
  37.     displayed on the toolbar of Win95.
  38. -----------------------------------------------------------------------------
  39. Function: win95_vmtitle_get(char * str1,dword strsiz)
  40. Expects: str1 = buffer for current VM name
  41.          strsiz = size of your string
  42. Outputs: 0 = successful
  43.          -1 = unsuccessful
  44. Notes:
  45.   This gets the VM name of the current running program that is
  46.     displayed on the toolbar of Win95.
  47.   The strsiz should be at least 80 bytes to get the entire string.
  48. -----------------------------------------------------------------------------
  49. Function: win95_close_enable(void)
  50. Expects: nothing.
  51. Outputs: 0 = successful
  52.          -1 = unsuccessful
  53. Notes:
  54.   Once enabled you must use the other win95_close...() functions to monitor
  55.     if the user has requested to close the program (by pressing the X button
  56.     of your DOS BOX)
  57. -----------------------------------------------------------------------------
  58. Function: win95_close_disable(void)
  59. Expects: nothing.
  60. Outputs: 0 = successful
  61.          -1 = unsuccessful
  62. -----------------------------------------------------------------------------
  63. Function: win95_close_query(void)
  64. Expects: nothing.
  65. Outputs: WIN95_CLOSE_NOACK = Close requested and not acknowledged
  66.          WIN95_CLOSE_ACK = Close requested and acknowledged
  67.          -1 = unsuccessful
  68. Notes:
  69.   After the close has been requested no input is given to program until
  70.     it acknowledges the close request.  See win95_close_ack().
  71. -----------------------------------------------------------------------------
  72. Function: win95_close_ack(void)
  73. Expects: nothing.
  74. Outputs: 0 = successful
  75.          -1 = unsuccessful
  76. Notes:
  77.   You should call this if win95_close_query() returns WIN95_CLOSE_NOACK.
  78. -----------------------------------------------------------------------------
  79. Function: win95_close_cancel(void)
  80. Expects: nothing.
  81. Outputs: 0 = successful
  82.          -1 = unsuccessful
  83. Notes:
  84.   You should call this if you have acknowledged a close request and have
  85.     desided you will not close at this time (ie: user canceled exit
  86.     operation)
  87. -----------------------------------------------------------------------------
  88.